home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / nt / blat11.zip / README < prev   
Text File  |  1994-12-08  |  4KB  |  104 lines

  1.  
  2. DESCRIPTION:
  3.  
  4. Blat is a Public Domain (generous aren't we?) Windows NT console utility which
  5. will e-mail a file to a user via SMTP. The program requires the "gensock" DLL
  6. (borrowed from WinVN). A Registry entry is generated when the program is used
  7. with the -SMTP flag. This stores the address of the SMTP server, and the 
  8. address of the _default_ sender (this may be overridden with the -f flag).
  9. Impersonation can be done with the -i flag which puts the value specified in
  10. place of the senders address in the "From:" line of the header, however if this
  11. is done the real senders address is stamped in the "Reply-To:" and "Sender:"
  12. lines. This can be useful when using the program to send message from NT users
  13. that are not registered on the SMTP host.
  14.  
  15.  
  16. SYNTAX: 
  17. syntax:
  18. Blat <filename> [-s <subject>] -t <recipient> -f <address> [-i <address>]
  19. Blat -SMTP <server address>
  20. Blat -h
  21.  
  22. -SMTP <server address> <senders address>: set's the address of the SMTP server t
  23. o be used
  24.  
  25. <filename>: the file with the message body
  26. -s <subject>: the (optional) subject line
  27. -t <recipient>: the recipient's address
  28. -c <recipient>: the carbon copy recipient's address
  29. -f <sender>: the sender's address (must be known to the SMTP server)
  30. -i <address>: a 'From:' address, not necessarily known to the SMTP server.
  31. -h: displays this help.
  32.  
  33. Note that if the '-i' option is used, <sender> is included in 'Reply-to:'
  34. and 'Sender:' fields in the header of the message.
  35.  
  36. INSTALLATION:
  37.  
  38. To set up Blat you need to:
  39.  
  40. 1) Copy the file "gensock.dll" to your "\WINNT\SYSTEM32" directory, or to any
  41.    other directory in your path. (Check if you already have it, if so only copy
  42.    the DLL if the date is more recent than the existing one)
  43.  
  44. 2) Copy the file "Blat.exe" to your "\WINNT\SYSTEM32" directory, or to any
  45.    other directory in your path.
  46.  
  47. 3) Run "Blat -SMTP yourhost.site.blah.blah youruserid@site.blah.blah"
  48.  
  49.  
  50. EXAMPLES:
  51.  
  52. Blat -SMTP smtphost.bar.com foo@bar.com          // Sets host and userid
  53. Blat -SMTP smtphost.bar.com foo                  // Sets host and userid
  54. Blat -SMTP smtphost.bar.com                      // Sets host only
  55.  
  56. Blat myfile.txt -s "A file for pedro" -t foo@bar.com
  57. // Sends a file with subject line "A file for pedro"
  58.  
  59. Blat myfile.txt -s "A file for mark" -t fee@fi.com -f foo@bar.com
  60. // -f option overrides the default sender
  61.  
  62. Blat myfile.txt -s "A file for pedro" -t foo@bar.com -i "devil@fire.hell"
  63. // -i replaces "From:" line address (but leaves Reply-To: and Sender: lines)
  64.  
  65. Blat myfile.txt -s "animals" -t fee@fi.com -c "moo@grass.edu,horse@meadow.hill"
  66. // -c mails carbon copies to users moo@grass.edu and horse@meadow.hill
  67.  
  68.         
  69. FUTURE IMPROVEMENTS (you can do it!)
  70.  
  71. 1) reorganize the code
  72. 2) include a Bcc: field
  73. 3) ability to specify SMTP server on the command line (wouldn't need registry)
  74. 4) get rich
  75. 5) go on holidays...
  76.  
  77.  
  78. COPYRIGHT
  79.  
  80. License to use Blat
  81.  
  82. The authors of Blat have placed it in the public domain. This means you
  83. can use it free of charge for any purpose you like, with no conditions being
  84. placed on its use by us. The source code is also available free of charge and
  85. under the same conditions as the executables.
  86.  
  87. You have permission to modify, redistribute, hoard, or even sell Blat in its
  88. executable or source form. If you do sell Blat, though, we'd appreciate it if
  89. you'd provide your own support (and send us a free copy).  We cannot take any
  90. support load for Blat (we've got better things to do). 
  91.  
  92. Various bits of the source code are copyright by other people/organizations.
  93. Look in the source code for copyright ownership.
  94.  
  95. The authors of the package are not responsible for any damage or losses that
  96. the usage of Blat may cause. We are especially not responsible for the misuse
  97. of the SMTP (or other) mail system.
  98.  
  99.  
  100. AUTHORS
  101.  
  102. Mark Neal    (mjn@aber.ac.uk)
  103. Pedro Mendes (prm@aber.ac.uk)
  104.